home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Light ROM 1
/
LIGHT-ROM 1 (Amiga Library Services)(1994).iso
/
ffdisks
/
d923.lha
/
RawInsert
/
RawInsert.doc
< prev
next >
Wrap
Text File
|
1993-10-07
|
5KB
|
122 lines
------------------------------------------------------------------------
RawInsert 1.0 (25.7.93) (w) Franz.Schwarz@mil.ka.sub.org - Public Domain
------------------------------------------------------------------------
RawInsert is a shell utility for Amiga-OS2.04 or above. It provides you
with the ability to insert text or any other input events like mouse
movements, disc changes, mouse key presses and so on into the input event
stream. This prooves especially useful in conjunction with Stefan Becker's
Toolmanager in order to control applications' graphical user interfaces
from ARexx scripts or shell batch files.
The command line argument stencil is
"DELAY=MILLISECS=MS/K/N,DESCR=D/S,FROM=FILE/K,TEXT/F"
The following are the arguments' meanings:
DELAY=MILLISECS=MS/K/N - Here you can specify the amount of time in
milliseconds to wait between inserting two InputEvents into the input
event stream. The numbers shall be within the range 0..999.
DESCR=D/S - switch that makes RawInsert parse the source data not
as plain ASCII text (default), but as input event descirption data.
These data consist of ordinary plain ASCII text that may furthermore
contain the following ESCape codes:
\n - linefeed (inserted as carriage return)
\r - carriage return
\0 - nul
\t - horizontal tab
\f - formfeed
\xff - ASCII code 0xff (f represents an arbitrary hex nibble)
\' - apostroph
\" - quotation mark
\< - left angled bracket '<'
\\ - backslash '\'
Moreover, separate input events may be specified according to Commodities'
ParseIX() syntax within angled brackets. The line
'<lcommand a><tab>Hello!<alt -capslock numericpad enter>\x06\t\5*x\<12\n'',
for example, represents valid input description data.
FROM=FILE/K - this argument specifies the file the input data shall be read
from. This argument and TEXT/F are mutually exclusive.
TEXT/F - the source data as command line argument; mutually exclusive with
FROM=FILE/K.
If none of the arguments FROM=FILE/K and TEXT/F is passed, stdin is used as
data source.
Linefeeds (0x0a) are automatically converted into carriage returns. In
addition to this, carriage returns are inserted as key presses of the
plain, simple carriage return rawkey unless the system default keymap
doesn't map that rawkey to carriage return.
In case of finding a character or an input event description surrounded by
angled brackets for which no matching input event can be generated,
RawInsert fails immediately with return code Dos.fail (20) if you have
specied the DESCR=D/S switch. No input events at all are inserted in this
case. However, if you haven't specified the DESCR=D/S argument, RawInsert
just skips that cruical source date and continues with the next one. You
can still detect that some input events couldn't be created by checking
the return code for Dos.warn.
Failure during reading source data causes RawInsert to terminate execution
immediately with Dos.fail (20) return code. No input events have been
inserted in that case.
Concerning the source data, note that all nul characters (0x00) are
excluded from processing, i.e. you can only insert nul into the input
event stream by specifying the DESCR=D/S argument and paraphrasing nul with
an ESCape sequence or a matching input event description in angled
brackets.
Since RawInsert is pure and brief, yet powerful, it's highly
recommened that you make RawInsert resident.
Implementation details: RawInsert imports the CxLib (corresponds to
Commodore's cx.lib) and BlackMagic (universal module - Chiefly, RawInsert
uses its support functions for dynamic strings) Oberon modules which are
both written by RawInsert's author (No, the author is not Joseph Stalin,
though he enjoys using third person singular for talking about himself;-)).
RawInsert is Public Domain, i.e. you may spread, use, abuse and 'do it'
with RawInsert just as you want. There is no copyright on RawInsert - the
author disclaims all titles and responsibilities that stem from writing
this piece of software. Of course, this means also 'You use this software
at your very own risk' - the author cannot be held liable for any harm that
may arise directly or indirectly from using (or watching;-)) this software
in any way whatsoever.
RawInsert written and not copyrighted, 1993 by
Franz Schwarz, Mühlenstraße 2, D-78591 Durchhausen, Germany.
uucp: Franz.Schwarz@mil.ka.sub.org; Fido: 2:241/7506.18
Suggestions, criticism, flames, money, gold, disks, beer, chocolate,
nice postcards, e-mails, etc. are welcomed and appreciated!;-)
Bye
Franz 'Blacky' Schwarz
-Girlfriend Is Better - Talking Heads-